home *** CD-ROM | disk | FTP | other *** search
/ Merciful 1 / Merciful - Disc 1.iso / software / s / sas_utilities / sasutilities02.dms / sasutilities02.adf / quadraplayer / QuadraPlayer.TXT / QuadraPlayer.TXT
Text File  |  1992-12-21  |  10KB  |  314 lines
  1. AUTHOR "Bo Lincoln"
  2.  
  3. ## $VER: QuadraPlayer.guide v1.2 (23.11.94)
  4.  
  5.  
  6.  
  7.                          QuadraPlayer v 1.2
  8.  
  9.                            By Bo Lincoln
  10.  
  11.                                    
  12.                     Copyright © 1994 Bo Lincoln.
  13.                         All rights reserved.
  14.  
  15.  
  16.  
  17.  
  18.                         U S E R  M A N U A L
  19.  
  20.  
  21. Distribution          Who can spread and use QuadraPlayer?
  22. Requirements          What do you need to run QuadraPlayer?
  23.  
  24. Windows               The user interface explained... :-)
  25.  
  26. History               What has been done?
  27.  
  28. DISTRIBUTION:
  29. You are hereby given permission to distribute the
  30. QuadraPlayer v1.2 and this manual, as long as you DON'T take any fee 
  31. for the program itself, only the costs for the media itself.
  32.  
  33. FREEWARE:
  34. QuadraPlayer is freeware, so you may use it and copy it as long as you
  35. follow the rules above. (You could always send me something if you like
  36. it... ;-) )
  37.  
  38. COPYRIGHTS:
  39. QuadraPlayer is Copyright © 1994 Bo Lincoln.
  40. QuadraPlayer makes use of reqtools.library for the requesters.
  41. ReqTools is Copyright © Nico François.
  42. Amiga is a registered trademark of Commodore-Amiga Inc.
  43.  
  44. DISCLAIMER
  45. (Don't blame me...)
  46.  
  47.    THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
  48. APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
  49. HOLDER AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
  50. OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
  51. THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  52. PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
  53. PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE
  54. COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  55.  
  56.    IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
  57. WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE
  58. PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
  59. GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
  60. USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS
  61. OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR
  62. THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
  63. PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
  64. POSSIBILITY OF SUCH DAMAGES.
  65.  
  66.  
  67. THE AUTHOR:
  68.  
  69. SnailMail:  Bo Lincoln
  70.             Rydsvägen 246 A:23
  71.             S-582 51 LINKÖPING
  72.             SWEDEN
  73.  
  74. Email:      d94bosli@isy.liu.se
  75.  
  76.  
  77. REQUIREMENTS:
  78.  
  79. What you need to run QuadraPlayer v1.2:
  80. * An Amiga 500(+), 600, 1000, 1200, 2000, 2500, 3000 or 4000 with
  81.   at least kickstart 2.0 installed.
  82. * "diskfont.library", "reqtools.library" and "gadtools.library".
  83. * Some nice modules.
  84. * Luck. (No no no, just kidding).
  85.  
  86. WINDOWS:
  87. (What does that button mean?)
  88.  
  89.      QuadraPlayer v1.2
  90.     +----------------------------------------------+
  91.     |Pick...Modlist...PopCorny.EMOD <>Iconify|
  92.     |       Play module        Loop Position     |
  93.     |          Stop              Options         |
  94.     |Position       |                          |<>|
  95.     |Position: 7 / 55  Time 1:16 / 6:43            |
  96.     |+-------------------------++-----------------+|
  97.     || VU-Meters   Monoscope ||        |||||||| ||
  98.     ||Spectrascope Analyzer  ||ChanVol:|||||||| ||
  99.     |+-------------------------++-----------------+|
  100.     +----------------------------------------------+
  101.  
  102.  
  103. PICK Main Window
  104.  
  105. Displays a file requester, in which you can choose one or more 
  106. modules to play. One of the choosen modules will be loaded.
  107. The modules will be added to / replace the module list.
  108. (This depending on the settings of Choosen Module).
  109.  
  110. MODULE LIST Main Window
  111.  
  112. This is a window displaying the names of the modules in the current
  113. module list. The module list is saved in the prefs file, see
  114. Save Prefs. Some modules will have the name of the song attached
  115. to the file name, this if you have choosen Load Name in the
  116. options window.
  117.  
  118. To choose a module in the list, double click on it.
  119. If you want to rearrange the module list, use the buttons in the
  120. bottom of the window.
  121.  
  122. The module list contains info about filename, path and (optionally) module
  123. name.
  124.  
  125. MODULE NAME Main Window
  126.  
  127. This displays the name of the current module.
  128. If you type a module file name here it will be treated as if you
  129. chose it in the Pick requester.
  130.  
  131. NEXT (PREVIOUS) MODULE Main Window
  132.  
  133. This will pick the next (previos) module in the Module List.
  134. If you have chosen Random in the Options window, it doesn't
  135. matter which button you press.
  136.  
  137. Shortkey: If a QuadraPlayer window is active, press right, enter
  138. or down for next module and up or left for previous module.
  139. You can always use the Shortkeys defined in the
  140. Options window.
  141.  
  142. ICONIFY Main Window
  143.  
  144. This button will remove the main window and put a little icon on
  145. the workbench. To open the window again, double click on the icon
  146. or use the Shortkeys defined in the Options window.
  147.  
  148. PLAY MODULE Main Window
  149.  
  150. Starts playing the current module at the current position.
  151.  
  152. Shortkey: If a QuadraPlayer window is active, press right alt.
  153.  
  154. LOOP POSITION Main Window
  155.  
  156. Loops the current position.
  157.  
  158. Shortkey: If a QuadraPlayer window is active, press right amiga.
  159.  
  160. STOP MODULE Main Window
  161.  
  162. Stops the module.
  163.  
  164. Shortkey: If a QuadraPlayer window is active, press space.
  165.  
  166. OPTIONS Main Window
  167.  
  168.      QuadraPlayer Options
  169.     +--------------------------------------------------------+
  170.     |+--------------------------------------++--------------+|
  171.     || Fade Out Time  | MonoScope Acc.   |||   Screen    ||
  172.     ||  Fade In Time |  Analyzer Speed |  ||+------------+||
  173.     |+--------------------------------------+||            |||
  174.     |+--------------------------------------+|+------------+||
  175.     ||    New Module    At Module End     |+--------------+|
  176.     || (O)              | |                 |+--------------+|
  177.     || (O)                                  ||              ||
  178.     ||                                      ||              ||
  179.     ||    At startup   Choosen Module(s)  ||              ||
  180.     || | |              (O)       | |       ||  Colours    ||
  181.     || | |              (O)                 ||              ||
  182.     ||                  (O)                 ||              ||
  183.     |+--------------------------------------+|              ||
  184.     |+--------------------------------------++--------------+|
  185.     || Next Mod  Prev Mod  Window  Mod List |                |
  186.     |||        ||        ||      ||       ||   About...    |
  187.     |+--------------------------------------+                |
  188.     |        Save             Use            Cancel       |
  189.     +--------------------------------------------------------+
  190.  
  191. Shortkey: If a QuadraPlayer window is active, press "o".
  192.  
  193. FADE TIME Options Window
  194.  
  195. This is where you set the time of the fade in / fade out when
  196. a new module is loaded. :*)
  197.  
  198. MONOSCOPE ACCURACY Options Window
  199.  
  200. This number is sets how many dots will be plotted per voice per frame
  201. in the monoscope.
  202.  
  203. ANALYZER SPEED Options Window
  204.  
  205. This is where you set the speed of the analyzer scrolling. 
  206.  
  207. NEW MODULE Options Window
  208.  
  209. (O) Next in list         <- When a new module is picked it will be in
  210.                             module list order...
  211. (O) Random               <- ...or in random order.
  212.  
  213. AT MODULE END Options Window
  214.  
  215. | | Load New             <- When the last position is reached,
  216.                             a new module will be loaded.
  217.  
  218. AT STARTUP Options Window
  219.  
  220. | | Load Module          <- Loads a module from the list when
  221.                             QuadraPlayer is started.
  222. | | Start Iconified      <- Startup with the main window iconified.
  223.  
  224. CHOOSEN MODULES Options Window
  225.  
  226. (O) Add To List          <- Adds the picked module(s) to the
  227.                             current module list.
  228. (O) Replace List         <- Replace the current list with the
  229.                             picked module(s).
  230. (O) Play Separately      <- If only one module is picked, it will
  231.                             not affect the module list, but it
  232.                             will be played.
  233. | | Load Name            <- When modules are picked, the names of
  234.                             the modules (not only the filenames) 
  235.                             will be read. Note: This function
  236.                             may be very slow...
  237.  
  238. SHORTKEYS Options Window
  239.  
  240. These shortkeys works globally on your Amiga:
  241. Next Mod                 <- The shortkey for load next module.
  242. Prev Mod                 <- The shortkey for load prev module.
  243. Window                   <- The shortkey to open the main window.
  244. Mod List                 <- The shortkey to open the module list window.
  245.  
  246. SCREEN Options Window
  247.  
  248. This is a list of all the available public screens on your Amiga.
  249. If you pick one, the QuadraPlayer windows will be moved to that one
  250. when "Use" or "Save" is pressed.
  251.  
  252. COLOURS Options Window
  253.  
  254. Here you can set the colour settings for the sample display windows.
  255.  
  256. ABOUT Options Window
  257.  
  258. Displays an about requester.
  259.  
  260. SAVE Options Window
  261.  
  262. Saves the current settings to the file "ENVARC:QuadraPlayer.prefs".
  263. If you have a module list it will be saved, too.
  264.  
  265. USE Options Window
  266.  
  267. Keeps the option changes.
  268.  
  269. CANCEL Options Window
  270.  
  271. Cancels all actions in the options window.
  272.  
  273. POSITION SLIDER Main Window
  274.  
  275. This slider shows the current module position. You move around the
  276. slider to set a new module position.
  277. Below this slider there is a text field which displays the current
  278. position number, and the time in the beginning of the position.
  279.  
  280. VU-METERS Main Window
  281.  
  282. Displays a window containing two (left, right) vu-meters.
  283.  
  284. SPECTRASCOPE Main Window
  285.  
  286. Displays a window containing a spectrum analyzer. It is not a
  287. FFT analyzer, but it works allright anyway.
  288.  
  289. MONOSCOPE Main Window
  290.  
  291. Displays a window containing a "MonoScope".
  292.  
  293. A lot of people keep asking how this effect is created, and I can
  294. tell you that it is very simple. But, if you can't figure
  295. it out anyway, you'll have to ask me... %-)
  296.  
  297. ANALYZER Main Window
  298.  
  299. This is a 256 point FFT analyer, displayed in 2D or "3D". If you
  300. make the window bigger, the filter curve will be scrolled.
  301.  
  302. HISTORY:
  303.  
  304. Ver:    Changes:
  305. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  306. 1.0        First public release.
  307. 1.1        Fixed LOTS of bugs.
  308.         Added module list.
  309. 1.2        Added analyzer.
  310.         Fixed "load module name" bug. It is now much
  311.         faster...
  312.         Fixed an add module bug / feature. Now one of the dropped /
  313.         picked modules is played, instead of one in the list.
  314.